home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Games / xpilot-3.3.1 / README < prev    next >
Encoding:
Text File  |  1995-07-09  |  5.2 KB  |  154 lines
  1. /     / //////
  2.  /   /  /     /   /    /        ////    /////
  3.   / /   /     /   /    /       /    /     /
  4.    /    //////    /    /       /    /     /
  5.   / /   /         /    /       /    /     /
  6.  /   /  /         /    /       /    /     /
  7. /     / /         /    //////   ////      /
  8.  
  9. ////////  R e l e a s e   3 . 2  ////////////
  10.  
  11.  
  12. COPYRIGHT & DISCLAIMER STUFF:
  13. \\\\\\\\\\\\\\\\\\\\\\\\\\\\\
  14.  
  15. Copyright (C) 1991-94 by
  16.  
  17.     Bjoern Stabell (bjoerns@acm.org),
  18.     Ken Ronny Schouten (kenrsc@stud.cs.uit.no) and
  19.     Bert Gijsbers (bert@mc.bio.uva.nl)
  20.                                 
  21. Please see the LICENSE file for further details.  You may not
  22. distribute this project without this file (README) and the
  23. LICENSE file included.
  24.  
  25.  
  26. NOTE:
  27. \\\\\
  28.  
  29. The documentation is far from complete, though we have tried to remove
  30. all the errors from it.  Because of lack of time, the map format is
  31. only explained in README.MAPS and README.MAPS2, not in the server
  32. manual page (xpilots(6)).  The client manual page (xpilot(6)) is more
  33. or less up to date.
  34.  
  35.  
  36. VMS:
  37. \\\\
  38.  
  39. *   VMS users should examine the VMS subdirectory and read the README.VMS
  40.     which is in there.
  41.  
  42.  
  43. REQUIREMENTS:
  44. \\\\\\\\\\\\\
  45.  
  46. XPilot require the following resources:
  47.  
  48.    - An ANSI C compiler (gcc with gcc-includes installed should work just fine,
  49.                          though many default compilers (like Sun's) are NOT
  50.                          ANSI C compliant so check and double check that the
  51.                          compiler you plan to use is ANSI C compliant.
  52.                          About 95% of all the problems reported is because
  53.                          users are not using an ANSI C compliant compiler!)
  54.    - X11                (only R4 and R5 tested, but R6 has been reported to work too)
  55.  
  56. Also note that XPilot generates heavy netload and isn't gentle with the X
  57. server, so a fast machine in a fast network is the ideal situation.
  58.  
  59.  
  60. INSTALLATION:
  61. \\\\\\\\\\\\\
  62.  
  63. *   Change current directory to the src directory.
  64.  
  65. *   Edit the config.h and Imakefile files to suit your environment.
  66.     You must define where you will put the XPilot lib directory and
  67.     possibly the XPilot maps directory too if it will not be in the
  68.     lib directory.  Also, there are likely to be some compiler
  69.     flags which you may need to enable.
  70.     If you don't have Imake, you can use Makefile.std
  71.     (just rename it to Makefile and type 'make' for more info).
  72.  
  73. *   If you have Imake, issue the following command:
  74.  
  75.         xmkmf -a
  76.  
  77.     If it fails (xmkmf doesn't understand the -a flag), do
  78.  
  79.         xmkmf
  80.         make Makefiles
  81.         make includes
  82.         make depend
  83.  
  84. *   Now compile:
  85.  
  86.         make
  87.  
  88.     If you get lots of errors, verify that you're using an ANSI C compiler.
  89.  
  90.     If you're compiling with gcc and get conflicting types for `abort'
  91.     and `exit', check that your include files has prototypes and if not,
  92.     that you have installed gcc-includes.  You should always install
  93.     gcc-includes if your system include files doesn't have prototypes.
  94.     (As a temporary hack, you may remove #include <stdlib.h> from all
  95.     the files.)
  96.  
  97. *   Install the executables in an appropriate place.  Or type:
  98.  
  99.         make install
  100.  
  101. *   Copy the maps to a suitable place (as specified in the config.h file).
  102.     On our system we have the LIBDIR set to /user/local/games/lib/xpilot.
  103.     An /bin/ls -l on this directory gives:
  104.  
  105.         total 500
  106.         -rw-r--r--   1 bjoerns  staff        739 Jun 25 02:27 defaults
  107.         -rw-rw-rw-   1 bjoerns  staff     29859  May  5 21:32 log    (+)
  108.         drwxr-xr-x   2 bjoerns  staff      1024  Apr  5 16:16 maps
  109.         -rw-r--r--   1 bjoerns  staff       320  Jun 20 13:20 motd
  110.         -rw-r--r--   1 bjoerns  staff       320  Jun 20 13:20 motd
  111.  
  112.     (+)Note, if you have logging enabled you will have to touch a file called
  113.        log in the LIBDIR and give other users write permission to it. This is
  114.        necessary since xpilot hasn't, and shouldn't have, the setuid bit set.
  115.  
  116.     Also note that the `motd' isn't included, you should make one yourself
  117.     if you feel the need for it.
  118.  
  119. *   If you want to use sound (rplay or NCD displays needed, see the Imakefile
  120.     or Makefile.std for more details), copy the src/lib/sounds file
  121.     to LIBDIR+"sounds".
  122.  
  123. *   Copy the manual pages to a suitable place.  You may succeed with:
  124.  
  125.         make install.man
  126.  
  127.     If you don't know where to put them, don't bother.  You may still read
  128.     them with the following command:
  129.  
  130.         nroff -man <man-file> | col | more
  131.  
  132.  
  133. MISCELLANEOUS INFORMATION:
  134. \\\\\\\\\\\\\\\\\\\\\\\\\\
  135.  
  136. See the manuals in the man6 directory for further reading.  If you're
  137. completely stuck, found a bug or just want to chat :), e-mail us at:
  138.  
  139.         xpilot@cs.uit.no
  140.  
  141. Remember to include the version of XPilot, your platform, the symptoms
  142. and a fix (if you have one) when reporting bugs.
  143.  
  144. Check out the contrib directory and the contrib/xpmtp subdirectory for
  145. some extra nifty programs.  Don't forget to get xmapedit from ftp.cs.uit.no
  146. in the directory /pub/games/xpilot/contrib.  Look in the same place for
  147. more XPilot contributed tools.
  148.  
  149. There is a mailing list for XPilot - please send an email to
  150. xpilot-request@cs.uit.no with subject `info' if you want to know more.
  151.  
  152. There is a newsgroup for XPilot: alt.games.xpilot.
  153.  
  154.